package com.ddm.service.vxService;

import com.ddm.vo.vxVo.ContestRankVO;
import com.ddm.vo.vxVo.ContestRankStatisticsVO;

import java.util.List;

/**
 * 竞赛排行榜服务接口
 */
public interface ContestRankService {
    
    /**
     * 获取竞赛排行榜
     * @param examId 竞赛ID
     * @param limit 限制返回数量
     * @return 排行榜列表
     */
    List<ContestRankVO> getContestRanking(Long examId, Integer limit);
    
    /**
     * 获取竞赛排行榜统计信息
     * @param examId 竞赛ID
     * @return 统计信息
     */
    ContestRankStatisticsVO getContestRankStatistics(Long examId);
    
    /**
     * 获取指定用户的竞赛排名
     * @param examId 竞赛ID
     * @param userId 用户ID
     * @return 用户排名信息
     */
    ContestRankVO getMyContestRank(Long examId, Long userId);
    
    /**
     * 获取综合竞赛排行榜
     * @param limit 限制返回数量
     * @return 综合排行榜列表
     */
    List<ContestRankVO> getOverallContestRanking(Integer limit);
} 